home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / standard / polymode.z / polymode
Encoding:
Text File  |  1998-10-20  |  6.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ppppoooollllyyyymmmmooooddddeeee((((3333GGGG))))                                                      ppppoooollllyyyymmmmooooddddeeee((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppoooollllyyyymmmmooooddddeeee - control the rendering of polygons
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      vvvvooooiiiidddd ppppoooollllyyyymmmmooooddddeeee((((lllloooonnnngggg mmmmooooddddeeee))))
  13.  
  14. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  15.      _m_o_d_e   Expects one of the symbolic constants:
  16.  
  17.             PPPPYYYYMMMM____PPPPOOOOIIIINNNNTTTT, draw only points at the vertices.
  18.  
  19.             PPPPYYYYMMMM____LLLLIIIINNNNEEEE, draw lines from vertex to vertex.
  20.  
  21.             PPPPYYYYMMMM____FFFFIIIILLLLLLLL, fill the polygon interior.
  22.  
  23.             PPPPYYYYMMMM____HHHHOOOOLLLLLLLLOOOOWWWW, fill only interior pixels at the boundaries.
  24.  
  25. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  26.      ppppoooollllyyyymmmmooooddddeeee specifies whether polygons are filled, outlined, drawn with
  27.      points at their vertices, or outlined with a hollow fill algorithm.
  28.      Affected polygons include all polygons that are normally filled,
  29.      including those generated by bbbbggggnnnnppppoooollllyyyyggggoooonnnn and eeeennnnddddppppoooollllyyyyggggoooonnnn, by bbbbggggnnnnttttmmmmeeeesssshhhh and
  30.      eeeennnnddddttttmmmmeeeesssshhhh, by bbbbggggnnnnqqqqssssttttrrrriiiipppp and eeeennnnddddqqqqssssttttrrrriiiipppp, by aaaarrrrccccffff, cccciiiirrrrccccffff, and rrrreeeeccccttttffff, and by
  31.      NURBS surfaces.  Also affected are polygons generated by the obsolete
  32.      ppppmmmmvvvv, ppppddddrrrr, and ppppcccclllloooossss commands, and by ppppoooollllffff and ssssppppoooollllffff.
  33.  
  34.      PPPPYYYYMMMM____FFFFIIIILLLLLLLL is the default mode.  In this mode polygons are filled with a
  35.      point-sample algorithm.  (Refer to the Graphics Library Programmer's
  36.      Guide for an detailed explanation of point-sampling.)
  37.  
  38.      PPPPYYYYMMMM____PPPPOOOOIIIINNNNTTTT causes a single point to be drawn at each polygon vertex,
  39.      including vertices generated by clipping.  All point rendering modes,
  40.      including antialiasing specified by ppppnnnnttttssssmmmmooooooootttthhhh, apply to these points.
  41.  
  42.      PPPPYYYYMMMM____LLLLIIIINNNNEEEE causes lines to be drawn from vertex to vertex around the
  43.      perimeter of the polygon.  This line forms a single outline, because it
  44.      passes through both projected vertices and vertices generated by
  45.      clipping.  All line rendering modes, including line width, line stipple
  46.      style, and line antialiasing specified by lllliiiinnnneeeessssmmmmooooooootttthhhh, apply to these
  47.      lines.
  48.  
  49.      PPPPYYYYMMMM____HHHHOOOOLLLLLLLLOOOOWWWW supports a special kind of polygon fill with the following
  50.      properties:
  51.  
  52.      1.   Only pixels on the polygon edge are filled.  These pixels form a
  53.           single-width line (regardless of the current lllliiiinnnneeeewwwwiiiiddddtttthhhh) around the
  54.           inner perimeter of the polygon.
  55.  
  56.      2.   Only pixels that would have been filled (PPPPYYYYMMMM____FFFFIIIILLLLLLLL) are changed (i.e.
  57.           the outline does not extend beyond the exact polygon boundary).
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ppppoooollllyyyymmmmooooddddeeee((((3333GGGG))))                                                      ppppoooollllyyyymmmmooooddddeeee((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      3.   Pixels that are changed take the _e_x_a_c_t color and depth values that
  75.           they would have had the polygon been filled.
  76.  
  77.      Because their pixel depth values are exact, hollow polygons can be
  78.      composed with filled polygons accurately.  Both hidden-line and scribed-
  79.      surface renderings can be done taking advantage of this fact.
  80.  
  81. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  82.      bgnpolygon, endpolygon, polysmooth, stencil
  83.  
  84. NNNNOOOOTTTTEEEESSSS
  85.      XS, XZ, Elan, and Extreme graphics support all ppppoooollllyyyymmmmooooddddeeee options except
  86.      ppppoooollllyyyymmmmooooddddeeee((((PPPPYYYYMMMM____HHHHOOOOLLLLLLLLOOOOWWWW)))).  IRIS-4D G, GT, and GTX models, as well as the
  87.      Personal Iris, Iris Entry, Indy, and XL systems do not support ppppoooollllyyyymmmmooooddddeeee.
  88.      Use ggggeeeettttggggddddeeeesssscccc to determine whether support for ppppoooollllyyyymmmmooooddddeeee is available.
  89.  
  90. BBBBUUUUGGGGSSSS
  91.      In order to support polygon fill mode PPPPYYYYMMMM____HHHHOOOOLLLLLLLLOOOOWWWW, IRIS-4D VGX and
  92.      RealityEngine models require that the following conditions be met:
  93.  
  94.      1.   Stencil planes be allocated (at least one plane).
  95.  
  96.      2.   The stencil planes be initialized to zero prior to drawing hollow
  97.           polygons.
  98.  
  99.      3.   The stencil planes be used for no other purpose while drawing hollow
  100.           polygons.  (The stencil function is controlled by the hardware and
  101.           must not be user specified.)
  102.  
  103.      IRIS-4D VGX models have an error in their microcode that results in
  104.      matching errors between pixels generated by PPPPYYYYMMMM____FFFFIIIILLLLLLLL and PPPPYYYYMMMM____HHHHOOOOLLLLLLLLOOOOWWWW in
  105.      some conditions.  This error will be corrected in the next software
  106.      release.
  107.  
  108.      PPPPYYYYMMMM____HHHHOOOOLLLLLLLLOOOOWWWW is not supported on Impact or Infinite Reality.
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.